HS_FORCE_VS

HS_FORCE_VS

   
SYNTAX:        

        HS_FORCE_VS(VS_NO, MODE, FORCE_V_VALUE, FORCE_I_VALUE, E_RANGE, I_RANGE   [, FORCE_V_OFFSET=x] [, FORCE_I_OFFSET=x] [, WAIT=x] [, ALL_SITE_ON/FAIL_SITE_ONLY/PLAN_FAIL_SITE_ONLY] [, SR0/SR1/SR2]);

        NOTE: The argument which can use _C_Variable (VS_NO, FORCE_V_VALUE, FORCE_I_VALUE, E_RANGE, I_RANGE [, FORCE_V_OFFSET=x] [, FORCE_I_OFFSET=x])

DESCRIPTION:

        Drive VS to force voltage or current.

REQUIRED ARGUMENT:

        PARA1: VS_NO

            HS_VS9~32 or power_source_name(string) that has been defined in the PRJ file. Or _C_Variable

        PARA2: MODE

            FORCE_V/FORCE_I.

            FORCE_V: V_LIMIT field set the force voltage value and I_LIMIT filed set the current clamp value. 

            FORCE_I: I_LIMIT field set the force current value and V_LIMIT filed set the voltage clamp value. 

        PARA3: FORCE_V_VALUE

            Voltage value,  unit: V, mV or  parameter name or GB1~64/MEASURE_VALUE/PinName variable or _C_Variable(double).

        PARA4: FORCE_I_VALUE

            Current value, unit: A, mA, uA, nA or  parameter name or GB1~64/MEASURE_VALUE/PinName variable or _C_Variable(double).

        PARA5: E_RANGE

            E1~E2; E1:กำ10V, E2:กำ24V

            Or _C_Variable

        PARA6: I-RANGE

            I1~I6; I1:กำ8UA, I2:กำ80UA, I3:กำ800uA, I4:กำ8mA, I5:กำ80mA I6:400mA

            KEEP_I_RANGE: I-RANGE reference to the same instruction as the previous settings

            Or _C_Variable

OPTIONAL ARGUMENT:

        PARA: FORCE_V_OFFSET=x

            x: Voltage value or parameter name or GB1~64/MEASURE_VALUE/PinName variable or _C_Variable(double). 

            This argument effect with LOOP_UNTIL_PASS_COUNT/LOOP_UNTIL_FAIL_COUNT

            FORCE_V_LIMIT increased the value of x with LOOP_PASS_COUNT/LOOP_FAIL_COUNT increased.

            Default: 0.

        PARA: FORCE_I_OFFSET=x

            x: Current value or parameter name or GB1~64/MEASURE_VALUE/PinName variable or _C_Variable(double).

            This argument effect with LOOP_UNTIL_PASS_COUNT/LOOP_UNTIL_FAIL_COUNT

            FORCE_I_LIMIT increased the value of x with LOOP_PASS_COUNT/LOOP_FAIL_COUNT increased.

            Default: 0.

        PARA: WAIT=x

            Wait time to next instruction.

            x range:10us-200s or parameter name; Unit: s or ms or us; 

            Default: 0ms, Resolution: 10us.

        PARA: ALL_SITE_ON/FAIL_SITE_ONLY/PLAN_FAIL_SITE_ONLY

            ALL_SITE_ON: Set driver executed on every site, even on the fail site.

            FAIL_SITE_ONLY: Driver executed on the fail site only.

            PLAN_FAIL_SITE_ONLY: Driver executed on the fail site ,it will occurs at this plan run Fail site only.

            Default: Driver executed on the pass site only.

        PARA: SR0/SR1/SR2

             slew rate control,

SR0: 10nF

SR1: 78nF

SR2: 510nF 

default: SR0

        

EXAMPLE:

          HS_FORCE_VS(HS_VS9, FORCE_V, 0.0V, 40UA, E1, I2);

        WAIT(1MS);

        HS_CLOSE_VS_OUTPUT_RELAY(HS_VS9, WAIT=3mS, ON);

        WAIT(1MS);

        HS_FORCE_VS(HS_VS9, FORCE_V, 3.0V, 40UA, E1, I2);

        WAIT(1MS);